home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.3 / Concat.3 < prev    next >
Encoding:
Text File  |  1995-07-26  |  2.7 KB  |  67 lines
  1.  
  2.  
  3.  
  4.      TTTTccccllll____CCCCoooonnnnccccaaaatttt((((3333))))                TTTTccccllll (((( ))))                TTTTccccllll____CCCCoooonnnnccccaaaatttt((((3333))))
  5.  
  6.  
  7.  
  8.      _________________________________________________________________
  9.  
  10.      NNNNAAAAMMMMEEEE
  11.           Tcl_Concat - concatenate a collection of strings
  12.  
  13.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.           ####iiiinnnncccclllluuuuddddeeee <<<<ttttccccllll....hhhh>>>>
  15.  
  16.           char *
  17.           TTTTccccllll____CCCCoooonnnnccccaaaatttt(_a_r_g_c, _a_r_g_v)
  18.  
  19.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  20.           int_a_r_g_c(in)
  21.           Number of strings.
  22.  
  23.           char*_a_r_g_v[](in)
  24.           Array of strings to concatenate.  Must have _a_r_g_c entries.
  25.      _________________________________________________________________
  26.  
  27.  
  28.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  29.           TTTTccccllll____CCCCoooonnnnccccaaaatttt is a utility procedure used by several of the Tcl
  30.           commands.   Given  a  collection of strings, it concatenates
  31.           them together  into  a  single  string,  with  the  original
  32.           strings   separated   by  spaces.   This  procedure  behaves
  33.           differently than TTTTccccllll____MMMMeeeerrrrggggeeee, in that the arguments are simply
  34.           concatenated:  no  effort  is  made  to  ensure  proper list
  35.           structure.  However, in most common usage the arguments will
  36.           all  be  proper lists themselves;  if this is true, then the
  37.           result will also have proper list structure.
  38.  
  39.           TTTTccccllll____CCCCoooonnnnccccaaaatttt eliminates leading and trailing white space as it
  40.           copies  strings  from  aaaarrrrggggvvvv to the result.  If an element of
  41.           aaaarrrrggggvvvv consists of nothing but white space, then  that  string
  42.           is  ignored entirely.  This white-space removal was added to
  43.           make the output of the ccccoooonnnnccccaaaatttt command cleaner-looking.
  44.  
  45.           The result string is dynamically allocated  using  mmmmaaaalllllllloooocccc(((())));
  46.           the  caller  must  eventually  release  the space by calling
  47.           ffffrrrreeeeeeee(((()))).
  48.  
  49.  
  50.      KKKKEEEEYYYYWWWWOOOORRRRDDDDSSSS
  51.           concatenate, strings
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 7/10/95)
  64.  
  65.  
  66.  
  67.